PATHMac OS 8 Developer Documentation > Operating System Services > Multiprocessing Services >

Adding Multitasking Capability to Applications Using Multiprocessing Services

MPExtractTaskState

Extracts state information from a suspended task.



 
OSStatus MPExtractTaskState (

                     MPTaskID task,

                     MPTaskStateKind kind,

                     void *info);

task: A value of type MPTaskID that specifies the task whose state information you want to obtain.
kind: A value of type MPTaskStateKind that specifies the kind of state information you want to obtain. See Task State Constants for a listing of possible values.
info: A pointer to a data structure to hold the state information. On return, the data structure holds the desired state information. The format of the data structure varies depending on the state information you want to retrieve. See the header file MachineExceptions.h for the formats of the various state information structures.
function result: A result code. See Result Codes for a list of possible values. If you attempt to extract state information for a running task, this function returns kMPInsufficientResourcesErr .

You can use this function to obtain register contents or exception information about a particular task.

Introduced with Multiprocessing Services 2.0.